home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / contrib / supported / xypic / src / xyps-txt.doc < prev    next >
Text File  |  1995-03-15  |  5KB  |  151 lines
  1. %% $Id: xyps-txt.doc,v 2.10 1994/06/15 12:46:03 ross Exp $
  2. %%
  3. %% XY-pic ``Textures driver''.
  4. %% Copyright (c) 1993-1994    Ross Moore    <ross@mpce.mq.edu.au>
  5. %%
  6. %% This file is part of the XY-pic package for graphs and diagrams in TeX.
  7. %% See the companion README and INSTALL files for further information.
  8. %% Copyright (c) 1991-1994    Kristoffer H. Rose    <kris@diku.dk>
  9. %%
  10. %% The XY-pic package is free software; you can redistribute it and/or modify
  11. %% it under the terms of the GNU General Public License as published by the
  12. %% Free Software Foundation; either version 2 of the License, or (at your
  13. %% option) any later version.
  14. %%
  15. %% The XY-pic package is distributed in the hope that it will be useful, but
  16. %% WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  17. %% or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  18. %% for more details.
  19. %%
  20. %% You should have received a copy of the GNU General Public License along
  21. %% with this package; if not, write to the Free Software Foundation, Inc.,
  22. %% 675 Mass Ave, Cambridge, MA 02139, USA.
  23. %%
  24. \ifx\xypsdviloaded\relax \message{not reloaded}\endinput \fi
  25. \let\xypsdviloaded=\relax \xycatcodes
  26.  
  27. \DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  28.  
  29. This included file (version \stripRCS$Revision: 2.10 $) provides \XY-ps
  30. support for the DVI driver of \Textures.\footnote{\Textures\ is a product of
  31. Blue Sky Research. \XY-ps has been tested on versions 1.5b and later; no
  32. guarantee is given for earlier versions.} for the
  33. Macintosh.\footnote{Macintosh is a trademark of Apple Computer Inc.}
  34.  
  35. \DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  36. \DOCHEADER
  37.  
  38. \Textures\ has only one kind of |\special|, 
  39. which must be used with the three classes of \PS\ command,
  40. and another for the ``raw'' \PS\ commands. 
  41. All \PS\ provided using |\special|s is executed in the environment 
  42. defined by the dictionary called |userdict|.
  43.  
  44. \DOCMODE(
  45. \xydef@\TexturesSpecial@#1{\firstPS@@\special{postscript #1}}
  46. \xydef@\TexturesMacro@#1{\firstPS@@\special{postscript mark{#1}xy}}
  47. \xydef@\TexturesInclude@#1{\firstPS@@\special{rawpostscriptfile #1}}
  48. \xydef@\TexturesRaw@#1{\firstPS@@\special{rawpostscript #1}}%
  49. \DOCMODE)
  50.  
  51. \HACK: \Textures\ requires the \PS\ dictionary to be shipped-out with
  52. every page. To achieve this efficiently we rebind |\shipout|, as described in
  53. the documentation for \XY-ps.
  54.  
  55. \DOCMODE(
  56. \xydef@\Textures@@{\gdef\dvitype@{Textures }\dvimessage@
  57.  \global\let\PSspecial@=\TexturesSpecial@
  58.  \global\let\PSmacro@=\TexturesMacro@
  59.  \global\let\PSdict@=\TexturesMacro@
  60.  \global\let\PSraw@=\TexturesRaw@
  61.  \global\let\PSinclude@=\TexturesInclude@
  62.  \global\let\xyPSobeylines@=\obeyTextureslines@
  63.  \ifUsePSdict@@
  64.   \global\let\XYdict@=\includeXYPSdict@ \fi
  65.  \gdef\firstPS@@{\firstPS@ \@PSshipout}%
  66.  \gdef\endXYdict@{\firstPS@}% 
  67.  \xyPSshapes@true
  68.  }%
  69.  
  70. \xywarnifdefined\obeyTextureslines@
  71. {\catcode`\^^M=\active
  72.  \gdef\obeyTextureslines@{\catcode`\^^M=\active \let^^M=\par \obeyspaces}}
  73. \DOCMODE)
  74.  
  75. Do it now.
  76.  
  77. \DOCMODE(
  78.   \Textures@@
  79. \DOCMODE)
  80.  
  81. This is the default |\xyPScurrpt@@|.
  82.  
  83. \DOCMODE(
  84. \gdef\xyPScurrpt@@{\PSspecial@{userdict begin 
  85.  0 0 transform grestore gsave itransform 
  86.  /xyYpos exch def /xyXpos exch def end}}
  87. \DOCMODE)
  88.  
  89. \DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  90.  
  91. \paragraph*{Rotations and Scaling}
  92.  
  93. \DOCMODE(
  94.  \xywithoption{line}{%
  95.   \xyinputorelse@{xyps-l.tex}{\xyerror@{Could not load xyps-l.tex}{}}}
  96.  \xycatcodes
  97.  \xywithoption{rotate}{%
  98.   \xyinputorelse@{xyps-r.tex}{\xyerror@{Could not load xyps-r.tex}{}}}
  99.  \xycatcodes
  100. \DOCMODE)
  101.  
  102. \DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  103.  
  104. \paragraph*{Extra  Colours}
  105.  
  106. Temporary: load all the colours anyway, while |xycolor| remains unwritten.
  107.  
  108. \DOCMODE(
  109.  \xywithoption{color}{%
  110.   \xyinputorelse@{xyps-col.tex}{\xyerror@{Could not load xyps-col.tex}{}}}
  111.  \xycatcodes
  112.  \xyinputorelse@{xyps-c.tex}{\xyerror@{Could not load xyps-c.tex}{}}
  113.  \xycatcodes
  114.  \xyinputorelse@{xyps-col.tex}{\xyerror@{Could not load xyps-col.tex}{}}
  115.  \xycatcodes
  116. \DOCMODE)
  117.  
  118. \DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  119.  
  120. \paragraph*{The end \& Log}\leavevmode
  121.  
  122. \DOCMODE(
  123. \xyendinput
  124.  
  125. % $Log: xyps-txt.doc,v $
  126. % Revision 2.10  1994/06/15  12:46:03  ross
  127. % Second release 3beta.
  128. % Colour and line style saving works; label colouring bug fixed.
  129. %
  130. % Revision 2.10  1994/06/15  12:46:03  ross
  131. % Second release 3beta.
  132. % Colour and line style saving works; label colouring bug fixed.
  133. %
  134. % Revision 2.9  1994/06/09  14:38:56  ross
  135. % Release 3beta.
  136. % Includes support for special effects: Rotations, Scaling, Line-width, Colour.
  137. % Back-ends are separated into separate files.
  138. % More back-ends are supported, experimentally --- needs testing.
  139. %
  140. % NEW for version 2.9 by Ross Moore.
  141. \DOCMODE)
  142.  
  143. \DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  144.  
  145. % Tell Emacs that this is a LaTeX document and how it is formatted:
  146. % Local Variables:
  147. % mode:latex
  148. % fill-column:77
  149. % fill-prefix:""
  150. % End:
  151.